A METHOD FOR RECORDING EVENTS IN AN IP NETWORK 



BACKGROUND OF THE INVENTION 
5 1 . Field of the Invention 

The present invention relates generally to telecommunications systems, and 

particularly to recording call event records in an IP network. 



2. Technical Background 

10 Telephony over the Internet is rapidly becoming a reality. Features that callers have 

come to expect from circuit switched systems are also considered essential for IP networks. 
One approach that is being considered to provide the system features needed to create and 
terminate calls in an IP network involves the Session Initiation Protocol (SIP). 

SIP is an application-layer signaling protocol that has been developed to create, 

15 modify, and terminate sessions having one or more users. These sessions include Internet 
telephone calls, multi-media conferences, and multi-media distribution. SIP functionality is 
typically resident on application servers. SIP servers are configured to provide telephonic 
services, and process call event information. Because vendors have developed their own 
custom SIP application programs, call events and telephonic services are processed by each 

20 vendor's apphcation server in a proprietary way. Unfortunately, when a network includes 
elements provided by a multiplicity of vendors, it becomes necessary to accommodate a 
variety of proprietary interfaces that enable the devices to transmit and receive call event 
information, billing information, monitoring information, fraud prevention data and other 
data. 

25 What is needed is a platform independent method for capturing SIP related events and 

other data in a uniform manner. Preferably, the system and method will be extensible, 
providing embedded information that will enable a receiving computer to read the generic, 
imiformly formatted records without needing a special proprietary interface. 



30 SUMMARY OF THE INVENTION 

The present invention relates to a platform independent method for capturing SIP 
related events and other data in a uniform manner. The method and system of the present 
invention is extensible. The method of the present invention produces generic, uniformly 



fomiatted records that can be read by a receiving computer without needing a special 
proprietary interface. 

One aspect of tiie present invention is a method for capturing call event data in a 
telecommunications network. The method includes generating at least one call event record 
5 in response to at least one event. An XML call event file is created that includes the at least 
one call event record. 

In another aspect, the present invention includes a computer readable medium that can 
be used to direct a Session Initiation Protocol (SIP) server computer to function in a specified 
manner. The computer readable medium includes a SIP application layer software module. 

10 The SIP application layer software module is executable by the SIP server computer to 
provide SIP functionality. A call event record module is coupled to the SIP application layer 
software module. The call event record module is configured to create at least one call event 
record in response to at least one event. An XML processor module is coupled to the call 
event record module. The XML processor module is configured to create an XML call event 

15 file. The XML call event file includes the at least one call event record. 

In another aspect, the present invention includes a set of application program 
interfaces embodied on a computer readable medium for execution on a computer. The set of 
application program interfaces includes a first interface that receives an event identifier and 
returns a call event record. The set of interfaces includes a second interface that receives a set 

20 of call event records and returns a call event file. The call event file includes the set of call 
event records. The call event file is an XML document written using the Extensible Markup 
Language (XML). 

In another aspect, the present invention includes a set of application program 
interfaces embodied on a computer readable medium for execution on a Session Initiation 

25 Protocol (SIP) server computer in conjunction with a SIP application layer software module 
that provides SIP functionality. The set of application program interfaces includes a first 
interface that receives a SIP event identifier and returns a call event record. The set of 
interfaces includes a second interface that receives a set of call event records and returns a 
call event file. The call event file includes the set of call event records. The call event file is 

30 written using the Extensible Markup Language (XML) and the call event file is an XML 
document. 
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In another aspect, the present invention includes a communications network for 
establishing a communications session between a first client and a second client. The 
communications network includes at least one Session Initiation Protocol (SIP) server 
computer. The SEP server computer includes a first call event record module configured to 
5 create a call event record corresponding to an event, and a first XML processor module 
configured to create a first XML call event file, the first XML call event file including the 
call event record. At least one network system is coupled to the at least one SIP server 
computer. The at least one network system includes a second XML processor module, 
whereby the at least one network system can read the first XML call event file. 

10 In another aspect, the present invention includes a computer-readable medium having 

stored thereon a data structure formatted as an XML document file. The data structure 
includes a server identifier section including information identifying the server that created 
the XML document file, a SIP message type section, and a SIP event section including 
information relating to a SIP message event. 

15 In another aspect, the present invention includes a computer readable medium having 

computer executable instructions for performing a method. The method includes the steps of: 
generating at least one call event record in response to at least one event; and, creating an 
XML call event file including the at least one call event record. 

Additional features and advantages of the invention will be set forth in the detailed 

20 description which follows, and in part will be readily apparent to those skilled in the art fi:om 
that description or recognized by practicing the invention as described herein, including the 
detailed description which follows, the claims, as well as the appended drawings. 
It is to be understood that both the foregoing general description and the following detailed 
description are merely exemplary of the invention, and are intended to provide an overview 

25 or firamework for understanding the nature and character of the invention as it is claimed. 
The accompanying drawings are included to provide a further understanding of the invention, 
and are incorporated in and constitute a part of this specification. The drawings illustrate 
various embodiments of the invention, and together with the description serve to explain the 
principles and operation of the invention. 

30 
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BRIEF DESCRIPTION OF THE DRAWINGS 

Figure 1 is a block diagram of a communications network for establishing a 
communications sessions between a first user and a second user in accordance with the 
present invention; 

5 Figure 2 is a block diagram of a SIP server in accordance with the present invention; 

Figure 3 is a diagrammatic depiction of the structure of a Call Event Record XML 
file; and 

Figure 4 is a chart showing a method for recording call events in accordance with the 
present invention. 

10 

DETAILED DESCRIPTION 

Reference will now be made in detail to the present exemplary embodiments of the 
invention, examples of which are illustrated in the accompanying drawings. Wherever 
possible, the same reference numbers will be used throughout the drawings to refer to the 
1 5 same or like parts. An exemplary embodiment of the communications network of the present 
invention is shown in Figure 1, and is designated generally throughout by reference numeral 
10. 

In accordance with the invention, the present invention relates to a method for 
capturing call related events and messages in a telecommunications network. The method 

20 includes the step of generating a call event record in response to a call related event. A call 
event file is created that includes the call event record. The call event file is an XML 
document file. Thus, the method of the present invention is extensible and platform 
independent. The method captures call related SIP events and other data such that any 
application server can process the data in a uniform way. The present invention provides a 

25 method for providing generic, uniformly formatted records that can be read by any network 
device. The system and method of the present invention includes embedded instructions that 
enable a receiving computer to decode the records without needing a special proprietary 
interface. 

As embodied herein, and depicted in Figure 1, a block diagram of a communications 
30 network for establishing a communications sessions between a first client and a second client 
in accordance with the present invention is disclosed. IP network 10 includes source client 



4 



12 coupled to SIP proxy server (SPS)14. Client 12 is referred to as a source client because it 
is the originator of the session participation request. Server 14 is coupled to SIP redirect 
server (RS)16, destination client 18 and network management system (NMS)20. Those of 
ordinary skill in the art will recognize that Figure 1 is merely a representative example. The 
5 present invention supports networks including a multiplicity of devices such as voice mail 
servers, conferencing servers and gateway devices. 

By way of example, source client 12 initiates a call attempt to destination client 18 by 
transmitting an INVITE request to SPS 14. SPS 14 acts as a proxy by relaying the INVITE 
message to client 18. If client 18 is available, client 18 transmits an OK message to client 12 

10 via SPS 14. On the other hand, if SPS 14 does not recognize the IP address of client 1 8, SPS 
14 may forward an INVITE message to RS 16. Subsequently, SPS 14 receives an alternative 
IP address for destination client 18 and provides that address to source client 12. Client 12 
retransmits an INVITE message to client 18 using the address provided by RS 16. The above 
described transactions are conducted using SIP request messages and SIP response messages 

15 which are also referred to as call events. The application servers record each call event in a 
call event record. All of the call event records produced over a predetermined amount of time 
are compiled in a Call Event Record file (CER file). The CER file is subsequently 
transmitted to NMS 20. Network status changes, fault conditions, and billing data, in 
addition to call event records can also be reported to NMS 20 via the CER files. In this way, 

20 billing, trouble-shooting, testing, and other back office functions resident in NMS 20 have 
access to the CER files. 

As embodied herein, and depicted in Figure 2, a block diagram of SIP server 100 in 
accordance with the present invention is disclosed. Server 100 includes SIP application 
software module 104 disposed in the memory of server computer 102. The memory of server 

25 computer 102 also includes call event record module 106 and other application software 
modules 110. SIP application software 104 provides SIP fimctionality. Call Event Record 
module 106 creates call event records in response to SIP call events or other events. XML 
processor 108 reads XML documents providing access to their content and structure. XML 
processor 108 does its work on behalf of application software modules. SIP application 

30 software modules 104 disposed in SPS 14 and RS 16, respectively, can be written as 
proprietary application software on different hardware platforms as long as each server 
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includes an XML processor. 

Referring back to Figure 2, module 104, module 106, module 108, and modules 1 10 
work together by way of a set of application program interfaces. One important interface 
receives call event information from SIP module 104 and provides it to Call Event Record 
5 module 106. Another important interface receives a set of call event records from Call Event 
Record module 106 and retams a Call Event Record (CER) file from module 108. The CER 
file includes the set of call event records collected by module 1 6 over a predetermined period 
of time. 

As embodied herein, and depicted in Figiu-e 3, a diagrammatic depiction of the 

10 structure of CER file 300 in accordance with the present invention is disclosed. The CER file 
is an XML document. As discussed above, the XML document is the data exchange 
mechanism between different proprietary systems - whether they be applications, databases, 
or browsers. XML documents include storage units known as entities which contain parsed 
data and unparsed data. Parsed data includes "markup," which is used to encode a description 

15 of the docvmients storage layout and logical structure. The self describing feature of XML is 
one of its most important attributes - extensibility. When the application produces data, the 
XML processor is called to create an XML document having specific "tags." A tag is a string 
of unparsed data bracketed by delimiting punctuation. The XML processor in the receiving 
server parses the received XML document to determine the storage layout and logical 

20 structure of the XML doctiment. However, the interpretation of the data is left to the 
application that calls XML processor 108. 

Referring back to Figure 3, CER file 300 has the following strucmre. It includes an 
XML document type declaration (DTD) section 302, server information section 304, SIP 
message type section 306, and event information section 308. DTD 302 provides a way of 

25 capturing the rules a designer adds to extend the core rules of XML syntax to thereby create a 
vocabulary to describe a particular event or situation. DTD section 302 also provides a way 
for an XML processor to unambiguously validate a particular XML document. DTD 302 
provides data to describe the data in the tags. They describe the relationship between the tags 
found in the document, what attributes the tags are supposed to have, what attributes are 

30 default, and what values are mandatory. The XML processor module interprets DTD 302 
accompanying the received XML document before providing the data to the application 
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program. 

Server information section 304 identifies the creator of CER file 300. This section 
appears only once in CER file 300. Since a particular server may provide specific services 
such as conferencing, instant messaging (IM), or voice mail, the service description as well as 
5 vendor information is provided by this section. 

SIP message type section 306 appears for each call event record. This section 306 
includes a message identifier field that identifies the exact type of message, e.g., whether it is 
an INVITE or a 200 OK message. SIP message type section 306 also includes a CALL-ID 
field which provides the CALL-ID header associated with a particular SIP message. SIP 

10 message type section 306 includes a service ID field that uniquely identifies the service 

instance associated with the SIP message. For example, if the application server is providing 
conferencing services, the service ID field identifies the particular conference corresponding 
to the SIP message. This allows one to obtain all messages exchanged during a specific 
conference within a specific time period. In another example, if the server is a voice mail 

1 5 system, the service ID would identify a particular voice mail box. In yet another example, the 
service ID would link together all messages and events for a given call estabhshed by a proxy 
server. SIP message type section 306 also includes a To/From field that records the IP 
address and port number of both the originating and receiving servers. In another 
embodiment, only one or the other will be present in this field. Finally, SIP message type 

20 section 306 includes an "other messages" field. This field records other portions of a SIP 
message deemed necessary depending on the type of server making the call event record. 
This information may include additional headers or it may be the actual message body of the 
SIP message. 

CER file 300 also includes an Event Information Section 308 for each record. Event 
25 Information Section 308 records other events encountered in processing a particular SIP 
message. These other events include "INVITE TIMEOUT," "NON-INVITE TIMEOUT," 
"CONNECTION ERROR," "AUTHENTICATION PERFORMED," "FIND-ME FEATURE 
INVOKED," "DAP query sent," and etc. There may also be additional fields containing 
detailed information about an event. Of course, any modifications to this field will be 
30 defined in the DTD section. 

As embodied herein, and depicted in Figure 4, a chart showing a method for recording 
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call events in accordance with the present invention is disclosed. In step 400, the application 
server creates CER file 300. The length of the file is configurable, that is, call event records 
and other data are written into the CER files for a predetermined period of time. After the 
time period elapses, a new CER file is started and the old file is archived by NMS 20. In step 
5 302 the application server determines if there is a call event, such as an INVITE, or some 
other such SIP message event. If so, the application server creates a call event record. 
Subsequently, the XML processor is called and the call event record is written in the CER file 
using XML. In step 308, the application server determines if the configurable file time period 
has elapsed. If not, the process flow returns to step 302 and the application server waits for 

10 another call event to record. If the time period has elapsed, the CER XML document file is 
transmitted to NMS 20 (See Figure 1). 

Those of ordinary skill in the art will recognize that CER files can be employed for 
any events occurring within network 10. Calls placed between all or any combinations of 
SIP-phones, enterprise gateways, network gateways, DAL gateways, INCP gateways, 

15 SIP-voicemail servers, and SIP conferencing servers may employ the present invention. 
Those of ordinary skill in the art will also recognize that the present invention can be 
employed using any suitable type of transport network. Further, the present invention is 
applicable to any type of session that may be established including, but not limited to, 
telephony, video, audio, instant messaging, and etcetera. It is also contemplated that the 

20 present mvention may be employed for billmg, monitoring, management, or for any of a wide 
variety of services performed by the network. 

It will be apparent to those skilled in the art that various modifications and variations 
can be made to the present invention without departing fi"om the spirit and scope of the 
invention. Thus, it is intended that the present invention cover the modifications and 

25 variations of this invention provided they come within the scope of the appended claims and 
their equivalents. 



